home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / utils / diagdemo / config.hlp < prev    next >
Text File  |  1994-08-24  |  8KB  |  221 lines
  1.  
  2. [Introduction]
  3.  
  4.  
  5.     This is the AMIDiag Configuration utility Help file.
  6.     The AMIDiag Configuration utility creates a set of
  7.     external variables used by AMIDiag. These variables are:
  8.     
  9.     *  a cache memory handler program,
  10.     *  a motherboard and memory configuration file, and
  11.     *  up to eight external diagnostics programs called by AMIDiag.
  12.  
  13.     You must first select a .DBS file when running the AMIDiag
  14.     Configuration utility. A .DBS file contains a catalog of all 
  15.     current configuration files. The .DBS file must be in the same
  16.     directory as the AMIDiag Configuration utility. The default 
  17.     filename is AMIDIAG.DBS. 
  18.  
  19.  
  20. [Main menu]
  21.  
  22.     The AMIDiag Configuration utility main menu choices are:
  23.     
  24.     A.      {Select Configuration}, 
  25.     B.      {Motherboard database maintenance},
  26.     C.      {Cache controller database maintenance}
  27.     D.      {You program database maintenance}
  28.     E.      Return to DOS.
  29.     
  30.     
  31.     
  32. [Select configuration]
  33.  
  34.     This screen displays the current catalogued .CCH, .PIC and .EXE
  35.     files in the selected DBS file. 
  36.  
  37.     You can browse through descriptions of these files. You can 
  38.     select one file from the CACHE window, one file from the MEMORY 
  39.     window and up to eight files from the User window. The selected
  40.     files are displayed in the SELECTION window.
  41.  
  42.     Freeze the file selections after you have selected the 
  43.     appropriate files. The AMIDiag Configuration utility prompts
  44.     you to enter the .CFG file name which will contain the file 
  45.     selections. The default .CFG file name is AMIDIAG.CFG.
  46.  
  47.     If a previously-created .CFG file is found in the directory, the
  48.     Configuration utility will try to load the previous selection after
  49.     making a consistency check.
  50.  
  51. [Motherboard database maintenance]
  52.  
  53.     This option lets the you create or edit a picture of the 
  54.     motherboard, including the CPU, components, and memory. You can
  55.     save this picture as a .{PIC file}.
  56.  
  57.     The memory map can be created and/or edited graphically
  58.     or nongraphically.The CPU component map can only be edited
  59.     graphically.
  60.  
  61.     See also - {Memory component editing}
  62.        {CPU component editing}
  63.  
  64.  
  65.  
  66.  
  67. [User program database maintenance]
  68.  
  69.     This option lets you add or delete a User program to the database. 
  70.     The User program must be in the .EXE file format. 
  71.  
  72.     The facility of linking User programs with AMIDiag allows
  73.     you to write your own diagnostic routines for devices that
  74.     AMIDiag does not diagnose, such as network cards, scanners, 
  75.     and optical devices. The {select configuration} menu allows 
  76.     you to select up to eight User programs from the database 
  77.     to be included in the AMIDiag User menu.
  78.  
  79.     The AMIDiag Configuration utility calls the User program using 
  80.     the following parameters:
  81.  
  82.     < Program name >  /I /Segment:Offset 
  83.  
  84.     segment:offset specifies a memory address where the user
  85.     program returns the signature and other salient information
  86.     about the User program. If the signature returned is correct, 
  87.     the User program is accepted and added to the database.
  88.  
  89.     See also - {User program parameters}
  90.  
  91. [Cache controller database maintenance]
  92.  
  93.     This option lets you add a new .{CCH file} to the database.
  94.     This process also checks the signature of the file and 
  95.     rejects the file if the signature is not correct.
  96.  
  97.  
  98. [Memory component editing]
  99.  
  100.     The AMIDiag Configuration program allows you to include a picture
  101.     of the motherboard for your computer in AMIDiag. You can then
  102.     link the AMIDiag diagnostic tests for various components (such as
  103.     the CPU, memory, and DMA Controller) to the motherboard picture.
  104.     Then if AMIDiag reports errors related to a specific motherboard
  105.     component, you can display a picture of the motherboard and 
  106.     the faulty component will flash.
  107.  
  108.     Motherboard memory is organized in banks. The AMIDiag 
  109.     Configuration utility allows you to identify up to eight 
  110.     banks of memory. Each memory bank can have different types 
  111.     of memory chips and a different architecture.
  112.     
  113.     The graphic memory identification screen lets you identify 
  114.     additional memory banks, delete existing memory banks, and create 
  115.     or change the description of the memory banks. 
  116.  
  117.     The nongraphic memory identification screen prompts you to 
  118.     name the ICs that make up each memory bank. 
  119.  
  120.     The graphic memory identification screen prompts you to specify 
  121.     the coordinates for chips 0 through n in memory banks 0 through n.
  122.     
  123.     In nongraphic memory identification mode, a chip diagram is 
  124.     displayed in Edit mode You can edit the chip names.
  125.  
  126.     
  127. [CPU component editing]
  128.  
  129.     You must start with a .PCX file that has a picture of the 
  130.     motherboard. A video camera snapshot of the motherboard can be
  131.     stores as a .PCX file.
  132.  
  133.     When graphically editing the CPU component map, you can display 
  134.     the .PCX file, and identify the motherboard components on the 
  135.     .PCX file .
  136.  
  137.     The .PCX image is displayed in 640 x 400 256-color mode. If the
  138.     display adapter does not support this resolution, you cannot
  139.     graphically edit the .PCX file.
  140.  
  141.  
  142. [PIC file]
  143.  
  144.  
  145.     The .PIC file allows AMIDiag to understand the memory 
  146.     organization on the motherboard. Once the memory organization is
  147.     understood, AMIDiag can pinpoint the location of the faulty 
  148.     memory chip when the AMIDiag memory tests return an error.
  149.  
  150.     The .PIC file has the following information:
  151.  
  152.     *  the motherboard manufacturer name,
  153.     *  the motherboard model number or serial number,
  154.     *  the names of the .PCX files for the motherboard or other
  155.        adapter cards that contain memory,
  156.     *  the total memory size,
  157.     *  the coordinates of CPU and associated chips, and
  158.     *  the memory bank organization for all memory banks.
  159.  
  160.     The memory organization contains further details, such as
  161.     chip type (DIP or SIMM), interleaving information, paging
  162.     information, whether the parity bit is located to the right
  163.     or to the left, etc.
  164.  
  165. [CCH file]
  166.  
  167.    .CCH files are user-supplied cache memory control programs. 
  168.    The binary image of a .CCH file should contain:
  169.  
  170.     *  the length of the program,
  171.     *  the vendor name and model number,
  172.     *  the cache control code and data, and
  173.     *  a checksum.
  174.  
  175.    The cache control code has to support the following functions:
  176.  
  177.     Function 0     Disable Cache
  178.     Function 1     Enable Cache
  179.     Function 2     Return Special info
  180.  
  181.     The last function must return a pointer to a list of I/O ports 
  182.     used for cache handling.
  183.  
  184.  
  185. [User program parameters] 
  186.  
  187.     Any user-defined diagnostics programs must be standard DOS 
  188.     programs in the .EXE file format. The modes of invocation are:
  189.  
  190.     Mode 1: Inquiry
  191.     ---------------
  192.  
  193.     The command line parameter is: < Program name > /I /Segment:Offset
  194.     
  195.     This is how the AMIDiag Configuration utility calls the User program.
  196.  
  197.     In this mode, the user program returns the following information in
  198.     segment:offset format:
  199.  
  200.     *  an 11-byte signature ("AMIDiag.UDG") to identify itself,
  201.     *  a 50-byte vendor name (null-terminated),
  202.     *  an eight byte model number,
  203.     *  a 24-byte menu line (this is the line displayed in the 
  204.        AMIDiag user menu window, such as "Network Test"), and
  205.     *  a 60-byte help line (this is the line displayed at the 
  206.        bottom of the AMIDiag screen.
  207.  
  208.     Mode 2: Execution
  209.     ------------------
  210.  
  211.     < Program name >  /X 
  212.  
  213.     This is how AMIDiag calls the User program. In this mode, the
  214.     user program should execute the diagnostic tests.
  215.  
  216.  
  217. [No help]
  218.  
  219.     There is no help on help
  220.       1
  221.